Skip to content

Add Agent Session Board canvas 🤖🤖🤖 - #6491

Merged
aaronpowell merged 8 commits into
github:mainfrom
hellices:add-fleet-control-board
Nov 18, 2026
Merged

aaronpowell merged 8 commits into
github:mainfrom
hellices:add-fleet-control-board

Conversation

@hellices

@hellices hellices commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the main branch for this pull request.

Description

Agent Session Board is a canvas for checking on several Copilot agent sessions and managing them while they work on one GitHub repository through issues, pull requests, reviews and merges.

Value: when several sessions run at once, the person supervising them needs to know three things at any moment:

  • what is waiting on them;
  • which pull request is stuck, and at which gate;
  • how much work is landing.

This board answers all three on one screen and keeps them current. It also gives agents a two-way channel back to that person.

  • Waiting on you: agents post questions with set_decisions. The user answers on the board, and agents read the answers with get_answers and acknowledge them with mark_answers_seen. Open issues that carry a configurable decision label are added too.

    • Each answer is tied to the exact version of its question, so a question that changes never receives an answer meant for an earlier version.
  • Progress by track: one row per configured label (milestone, area, phase), with checklist progress, closed and total issues, and merge counts. Optional bars show epic sub-issue progress. Each merge is assigned to a track by checking, in order:

    1. the PR's own labels
    2. labels on the issues it closes or references
    3. labels on those issues' parent epics
  • Sessions: one card per agent session, matched by PR number, branch pattern or title pattern. Each PR shows the first merge gate it still has to pass, one of:

    • draft, conflict
    • CI failed, CI running
    • changes requested, unresolved threads, awaiting review, no review on the latest commit
    • mergeability still being computed

    Idle sessions are flagged.

  • Merge flow: hourly bars for the last 24 clock hours and daily bars for the last 7 calendar days, stacked by track. Each chart has a data table for screen-reader and keyboard users.

  • Warnings: CI failures, conflicts, stale PRs, a low API budget, expired merge locks, and data too large to load completely.

  • Local resources (optional): the header shows free memory, swap and heavy-job counts, with limits.

  • Merge lock lane (optional): reads merge lock:, merge reserve: and merge lock release: lines from a coordination issue. A line counts only when its author's write access is verified, or when the author is on a configured lockAuthors list.

Open it with { "repo": "owner/name" }, or with { "demo": true } for fictional sample data. Its actions are refresh, get_summary, configure_board, set_decisions, get_answers and mark_answers_seen. The board is in English by default. Calling configure_board with language: "ko" switches it to Korean.

Safety and data handling

  • No npm dependencies.
  • GitHub data comes only through the user's gh CLI. The board never reads or stores tokens.
  • All process execution lives in one small module, lib/exec.mjs. It runs only an allowlist: gh, plus ps, sysctl and memory_pressure for the optional local checks. Commands run without a shell, with arguments as an array, a timeout and an output cap.
  • If gh is missing or signed out, the board shows the setup steps instead of loading data. Demo mode works without gh.
  • The local server listens on 127.0.0.1 on an ephemeral port.
    • Every route sits under a random per-panel key that only the canvas host receives. That key opens only this local board and is not a GitHub credential.
    • The server checks the Host header, accepts only same-origin JSON posts, and refuses to be framed.
  • Per-repository state lives in <copilot-home>/extension-data/agent-session-board/. Each file has a format marker and version, and is written atomically under a lock file, so several sessions can share one board safely.
  • open() is idempotent per instanceId.

Agent Session Board with demo data

The screenshot uses the built-in demo data only.


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • New canvas extension.
  • Update to existing instruction, prompt, agent, plugin, skill, workflow, or canvas extension.
  • Other (please specify):

Additional Notes

This PR was authored by an AI agent (GitHub Copilot) for @hellices, per the CONTRIBUTING note on AI-authored submissions. A human reviews it before it leaves draft.

Validation

  • node --check on every module: passed.
  • node --test test/*.test.mjs in extensions/agent-session-board: 36/36 passed. The tests cover:
    • the three-step track attribution
    • lock parsing, expiry offsets, and trusted lock authors
    • merge-gate order, including branch-rule states such as behind and blocked
    • session matching
    • rejection of unsafe patterns, and deadline-bound pattern matching in a worker thread
    • question revisions
    • chart windows, including the end of daylight saving time
    • reporting of incomplete data
    • store format checks, stale-lock recovery, and a multi-process write test
  • npm run plugin:validate and npm run build: passed.
  • Tested live in the Copilot app:
    1. extensions_reload, then list_canvas_capabilities.
    2. open_canvas with demo data and with github/awesome-copilot.
    3. refresh, get_summary and configure_board.
    4. The decision round trip: set_decisions, an answer from the page, get_answers, then mark_answers_seen.
    5. Reopening the same instanceId returned the same URL, and settings came back after an extension restart.
  • Copilot review rounds 1-5 (45 comments) are answered and fixed.

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

…ry work

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 18, 2026 10:08
@github-actions github-actions Bot added canvas-extension PR touches canvas extensions new-submission PR adds at least one new contribution plugin PR touches plugins labels Nov 18, 2026
@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 19 changed file(s).

Severity Count
🔴 High 0
🟠 Medium 1
ℹ️ Info 0
Severity Rule File Line Match
🟠 unpinned-version-indicator extensions/agent-session-board/README.md 49 { "label": "area: docs", "name": "Docs", "group": "Areas", "titlePattern": "^docs:" }
Skipped non-text or missing files
  • extensions/agent-session-board/assets/preview.png

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

🧩 Canvas smoke test

✅ Passed · 0 error(s), 4 warning(s)

Check Result
Syntax, imports, file safety ✅
Preview image (≥ 400×160 PNG) ✅
Plugin manifests ✅
Materialize ✅
Install (Copilot CLI) ✅

Plugin agent-session-board v1.0.0

Field Value
Description Supervise several Copilot sessions working one GitHub repository: a decision queue, progress by label track, merge-gate status for every PR, hourly and daily merge flow, warnings, and an optional merge-lock lane.
Author hellices — https://github.com/hellices
License MIT
Keywords canvas, copilot-extension, dashboard, merge-queue, multi-agent, pull-requests, supervision
Extensions agent-session-board
Materialize ✅
Install ✅
Changed plugin files
  • plugins/agent-session-board/README.md
  • plugins/agent-session-board/plugin.json

Extension agent-session-board

agent-session-board preview

Field Value
Registered by agent-session-board
Package agent-session-board 1.0.0
Preview 1280×720, 158.2 KB
Modules 14 (8 reachable from extension.mjs)
Files 17

Permissions and capabilities (static analysis of modules reachable from extension.mjs)

  • Spawns processes (node:child_process)
  • File system access (node:fs)
  • Network sockets / local server (node:http, node:net, ...)
  • Worker threads / child processes (node:worker_threads, node:cluster)
  • Host information (node:os)
  • Outbound HTTP requests (fetch)
  • Reads environment variables (process.env)

Warnings

  • test/collect.test.mjs: import "node:test" is not a Node.js builtin, host-provided package, or declared dependency (module is not reachable from extension.mjs)
  • test/exec.test.mjs: import "node:test" is not a Node.js builtin, host-provided package, or declared dependency (module is not reachable from extension.mjs)
  • test/pattern.test.mjs: import "node:test" is not a Node.js builtin, host-provided package, or declared dependency (module is not reachable from extension.mjs)
  • test/store.test.mjs: import "node:test" is not a Node.js builtin, host-provided package, or declared dependency (module is not reachable from extension.mjs)
Changed extension files
  • extensions/agent-session-board/README.md
  • extensions/agent-session-board/assets/preview.png
  • extensions/agent-session-board/extension.mjs
  • extensions/agent-session-board/lib/collect.mjs
  • extensions/agent-session-board/lib/demo.mjs
  • extensions/agent-session-board/lib/exec.mjs
  • extensions/agent-session-board/lib/match-worker.mjs
  • extensions/agent-session-board/lib/page.mjs
  • extensions/agent-session-board/lib/pattern.mjs
  • extensions/agent-session-board/lib/server.mjs
  • extensions/agent-session-board/lib/store.mjs
  • extensions/agent-session-board/package.json
  • extensions/agent-session-board/test/collect.test.mjs
  • extensions/agent-session-board/test/exec.test.mjs
  • extensions/agent-session-board/test/fixtures/board-writer.mjs
  • extensions/agent-session-board/test/pattern.test.mjs
  • extensions/agent-session-board/test/store.test.mjs

Static checks compile modules without executing them. Minimum preview size is configurable with CANVAS_PREVIEW_MIN_WIDTH/CANVAS_PREVIEW_MIN_HEIGHT. Workflow run

@github-actions

github-actions Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

🚦 Submission status: 👀 Ready for review

Risk tier: merge-risk:high — Privileged execution, automation, or review-policy change
Required to merge: passing submission-gate checks plus 1 approval from reviewers with write access, including a maintainer with admin or maintain permission.

Why this tier
  • Spawns processes or evaluates code in extensions/agent-session-board/lib/exec.mjs

Automated checks

Check Status Details
Line endings ✅ Passed Passed · logs
Spelling ✅ Passed Passed · logs
Generated README consistency ✅ Passed Passed · logs
Plugin and extension validation ✅ Passed Passed · logs
Canvas extension validation ✅ Passed Passed · logs
Plugin structure ✅ Passed Passed · logs
Risk scan ✅ Passed Passed · logs
Contributor reputation ✅ Passed Passed · logs
Duplicate resource scan ✅ Passed Passed · logs
PR quality signal ⏭️ Skipped Skipped by its workflow · logs
Canvas/plugin smoke test ✅ Passed Passed · logs

Review

  • Approvals: 0/1
  • Assigned reviewer: not assigned yet — comment /request-review to ask for one
  • Review target date: not set
  • Still needed: 1 more approval(s); an approval from a maintainer with admin or maintain permission
  • The core-maintainers pool is not staffed yet; an approver with admin or maintain permission is required instead.

Commands

Command Who What it does
/rerun-checks PR author, maintainers Re-runs failed or incomplete checks and re-evaluates this gate
/request-review PR author, maintainers Asks the review rotation to assign a reviewer (adds needs-reviewer)

Updated for 7faa0cd · gate run · This comment is maintained automatically — see submission gate docs.

@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Nov 18, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Unresolved critical flaws allow unauthorized access and decision submission, lost updates across sessions, and false merge-readiness signals from unknown or incomplete GitHub data.

16 open issues
What changed in this PR

Adds Fleet Control Board, a canvas extension and installable plugin for supervising multiple Copilot sessions working in one GitHub repository.

Changes:

  • Adds decision queues, track progress, session merge gates, merge-flow charts, warnings, and optional merge-lock tracking.
  • Implements GitHub CLI data collection, persistent board state, a local server, and an English/Korean interface.
  • Includes demo data, focused unit tests, usage documentation, and plugin catalog registration.
File Description
plugins/​fleet-control-board/​README.md Documents plugin installation and usage.
plugins/​fleet-control-board/​plugin.json Registers the plugin and bundled extension.
extensions/​fleet-control-board/​test/​store.test.mjs Tests storage and input validation.
extensions/​fleet-control-board/​test/​collect.test.mjs Tests attribution, locks, gates, and state assembly.
extensions/​fleet-control-board/​README.md Documents features, actions, configuration, and privacy.
extensions/​fleet-control-board/​package.json Defines extension metadata and the test command.
extensions/​fleet-control-board/​lib/​store.mjs Provides persistent state and input validation.
extensions/​fleet-control-board/​lib/​server.mjs Serves the board and local API endpoints.
extensions/​fleet-control-board/​lib/​page.mjs Implements the localized dashboard and answer controls.
extensions/​fleet-control-board/​lib/​demo.mjs Supplies fictional demonstration data.
extensions/​fleet-control-board/​lib/​collect.mjs Collects GitHub data and derives board metrics.
extensions/​fleet-control-board/​extension.mjs Connects canvas lifecycle, actions, and caching.
docs/​README.plugins.md Adds the plugin to the documentation catalog.
.github/​plugin/​marketplace.json Adds the marketplace entry.

Review effort: Balanced

…nglish default

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 18, 2026 10:57
@github-actions github-actions Bot added awaiting-automation and removed ready-for-review Submission passed intake validation and is ready for maintainer review labels Nov 18, 2026
@hellices hellices changed the title Add Fleet Control Board canvas Add Fleet Control Board canvas 🤖🤖🤖 Nov 18, 2026
@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Nov 18, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Stale-lock recovery can delete another writer’s live lock and lose board updates, while excessive regular-expression backtracking can freeze all boards and actions.

8 open issues
16 resolved since last review

Review effort: Balanced

…visions, DST buckets, accessibility

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 18, 2026 11:19
@github-actions github-actions Bot added awaiting-automation ready-for-review Submission passed intake validation and is ready for maintainer review and removed ready-for-review Submission passed intake validation and is ready for maintainer review awaiting-automation labels Nov 18, 2026
@hellices hellices changed the title Add Fleet Control Board canvas 🤖🤖🤖 Add Agent Session Board canvas 🤖🤖🤖 Nov 18, 2026
@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Nov 18, 2026
@hellices
hellices marked this pull request as ready for review November 18, 2026 13:01
@hellices
hellices requested review from a team as code owners November 18, 2026 13:01

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

…hing, attribution limits, light theme contrast

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 18, 2026 13:35
@github-actions github-actions Bot added awaiting-automation and removed ready-for-review Submission passed intake validation and is ready for maintainer review labels Nov 18, 2026
@github-actions github-actions Bot added ready-for-review Submission passed intake validation and is ready for maintainer review and removed awaiting-automation labels Nov 18, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

…est, permission level, lock backoff

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 18, 2026 13:48

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Human assessment is needed because background refreshes can bind an existing draft to a changed question, allowing an answer intended for an earlier revision to be submitted.

No open issues 🎉

5 resolved since last review

Review effort: Balanced

… and use worker threads in tests

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 18, 2026 14:12

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

Human assessment is needed because unpublished findings identify critical risks of submitting drafts against changed questions and reporting PRs as mergeable from incomplete review-thread data.

No open issues 🎉

Review effort: Balanced

@hellices

Copy link
Copy Markdown
Contributor Author

/request-review

@github-actions

Copy link
Copy Markdown
Contributor

🙋 Added needs-reviewer. Reviewer routing is assigning a reviewer now.

@aaronpowell aaronpowell left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for contributing this canvas. It adds a focused workflow for supervising sessions across PR gates, label-based progress, and question handoffs. The repository’s existing Agent Radar is focused on local session and data-flow visibility, while this board is centered on work moving through a configured repository. CI reports the plugin validation, build, and canvas smoke test passing, and the README documents the gh-based data path and demo mode. This is a useful addition to the Copilot canvas collection.

@aaronpowell
aaronpowell merged commit 1a8e8f1 into github:main Nov 18, 2026
37 of 39 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

canvas-extension PR touches canvas extensions merge-risk:high needs-reviewer new-submission PR adds at least one new contribution plugin PR touches plugins ready-for-review Submission passed intake validation and is ready for maintainer review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants